<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html><html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <title>glGetRenderbufferParameteriv - OpenGL ES 3 Reference Pages</title>
    <link rel="stylesheet" type="text/css" href="opengl-man.css"/>
    <meta name="generator" content="DocBook XSL Stylesheets V1.78.1"/>
    <script type="text/x-mathjax-config">
            MathJax.Hub.Config({
                MathML: {
                    extensions: ["content-mathml.js"]
                },
                tex2jax: {
                    inlineMath: [['$','$'], ['\\(','\\)']]
                }
            });
        </script>
    <script type="text/javascript" src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"/>
  </head>
  <body>
    <header/>
    <div class="refentry" id="glGetRenderbufferParameteriv">
      <div class="titlepage"/>
      <div class="refnamediv">
        <h2>Name</h2>
        <p>glGetRenderbufferParameteriv — retrieve information about a bound renderbuffer object</p>
      </div>
      <div class="refsynopsisdiv">
        <h2>C Specification</h2>
        <div class="funcsynopsis">
          <table style="border: 0; cellspacing: 0; cellpadding: 0;" class="funcprototype-table">
            <tr>
              <td>
                <code class="funcdef">void <strong class="fsfunc">glGetRenderbufferParameteriv</strong>(</code>
              </td>
              <td>GLenum <var class="pdparam">target</var>, </td>
            </tr>
            <tr>
              <td> </td>
              <td>GLenum <var class="pdparam">pname</var>, </td>
            </tr>
            <tr>
              <td> </td>
              <td>GLint *<var class="pdparam">params</var><code>)</code>;</td>
            </tr>
          </table>
          <div class="funcprototype-spacer"> </div>
        </div>
      </div>
      <div class="refsect1" id="parameters">
        <h2>Parameters</h2>
        <div class="variablelist">
          <dl class="variablelist">
            <dt>
              <span class="term">
                <em class="parameter">
                  <code>target</code>
                </em>
              </span>
            </dt>
            <dd>
              <p>
                    Specifies the target of the query operation. <em class="parameter"><code>target</code></em> must be <code class="constant">GL_RENDERBUFFER</code>.
                </p>
            </dd>
            <dt>
              <span class="term">
                <em class="parameter">
                  <code>pname</code>
                </em>
              </span>
            </dt>
            <dd>
              <p>
                    Specifies the parameter whose value to retrieve from the renderbuffer bound to <em class="parameter"><code>target</code></em>.
                </p>
            </dd>
            <dt>
              <span class="term">
                <em class="parameter">
                  <code>params</code>
                </em>
              </span>
            </dt>
            <dd>
              <p>
                    Specifies the address of an array to receive the value of the queried parameter.
                </p>
            </dd>
          </dl>
        </div>
      </div>
      <div class="refsect1" id="description">
        <h2>Description</h2>
        <p>
            <code class="function">glGetRenderbufferParameteriv</code> retrieves information about a bound renderbuffer object. <em class="parameter"><code>target</code></em>
            specifies the target of the query operation and must be <code class="constant">GL_RENDERBUFFER</code>. <em class="parameter"><code>pname</code></em> specifies
            the parameter whose value to query and must be one of <code class="constant">GL_RENDERBUFFER_WIDTH</code>, <code class="constant">GL_RENDERBUFFER_HEIGHT</code>,
            <code class="constant">GL_RENDERBUFFER_INTERNAL_FORMAT</code>, <code class="constant">GL_RENDERBUFFER_RED_SIZE</code>, <code class="constant">GL_RENDERBUFFER_GREEN_SIZE</code>,
            <code class="constant">GL_RENDERBUFFER_BLUE_SIZE</code>, <code class="constant">GL_RENDERBUFFER_ALPHA_SIZE</code>, <code class="constant">GL_RENDERBUFFER_DEPTH_SIZE</code>,
            <code class="constant">GL_RENDERBUFFER_STENCIL_SIZE</code>, or <code class="constant">GL_RENDERBUFFER_SAMPLES</code>.
        </p>
        <p>
            Upon a successful return from <code class="function">glGetRenderbufferParameteriv</code>, if <em class="parameter"><code>pname</code></em> is <code class="constant">GL_RENDERBUFFER_WIDTH</code>,
            <code class="constant">GL_RENDERBUFFER_HEIGHT</code>, <code class="constant">GL_RENDERBUFFER_INTERNAL_FORMAT</code>, or <code class="constant">GL_RENDERBUFFER_SAMPLES</code>,
            then <em class="parameter"><code>params</code></em> will contain the width in pixels, the height in pixels, the internal format, or the number of samples, respectively,
            of the image of the renderbuffer currently bound to <em class="parameter"><code>target</code></em>.
        </p>
        <p>
            If <em class="parameter"><code>pname</code></em> is <code class="constant">GL_RENDERBUFFER_RED_SIZE</code>, <code class="constant">GL_RENDERBUFFER_GREEN_SIZE</code>,
            <code class="constant">GL_RENDERBUFFER_BLUE_SIZE</code>, <code class="constant">GL_RENDERBUFFER_ALPHA_SIZE</code>, <code class="constant">GL_RENDERBUFFER_DEPTH_SIZE</code>,
            or <code class="constant">GL_RENDERBUFFER_STENCIL_SIZE</code>, then <em class="parameter"><code>params</code></em> will contain the actual resolutions (not the resolutions
            specified when the image array was defined) for the red, green, blue, alpha depth, or stencil components, respectively, of the image of the
            renderbuffer currently bound to <em class="parameter"><code>target</code></em>.
        </p>
      </div>
      <div class="refsect1" id="errors">
        <h2>Errors</h2>
        <p>
            <code class="constant">GL_INVALID_ENUM</code> is generated if <em class="parameter"><code>pname</code></em> is not one of the accepted tokens.
        </p>
      </div>
      <div class="refsect1" id="versions">
        <h2>API Version Support</h2>
        <div class="informaltable">
          <table style="border-collapse: collapse; border-top: 2px solid ; border-bottom: 2px solid ; border-left: 2px solid ; border-right: 2px solid ; ">
            <colgroup>
              <col style="text-align: left; "/>
              <col style="text-align: center; " class="firstvers"/>
              <col style="text-align: center; " class="lastvers"/>
            </colgroup>
            <thead>
              <tr>
                <th style="text-align: left; border-right: 2px solid ; ">
                 
            </th>
                <th style="text-align: center; border-bottom: 2px solid ; " colspan="2">
                <span class="bold"><strong>OpenGL ES API Version</strong></span>
            </th>
              </tr>
              <tr>
                <th style="text-align: left; border-right: 2px solid ; border-bottom: 2px solid ; ">
                <span class="bold"><strong>Function Name</strong></span>
            </th>
                <th style="text-align: center; border-right: 2px solid ; border-bottom: 2px solid ; ">
                <span class="bold"><strong>2.0</strong></span>
            </th>
                <th style="text-align: center; border-bottom: 2px solid ; ">
                <span class="bold"><strong>3.0</strong></span>
            </th>
              </tr>
            </thead>
            <tbody>
              <tr>
                <td style="text-align: left; border-right: 2px solid ; ">glGetRenderbufferParameteriv</td>
                <td style="text-align: center; border-right: 2px solid ; ">✔</td>
                <td style="text-align: center; ">✔</td>
              </tr>
            </tbody>
          </table>
        </div>
      </div>
      <div class="refsect1" id="seealso">
        <h2>See Also</h2>
        <p>
            <a class="citerefentry" href="glGenRenderbuffers.xhtml"><span class="citerefentry"><span class="refentrytitle">glGenRenderbuffers</span></span></a>,
            <a class="citerefentry" href="glFramebufferRenderbuffer.xhtml"><span class="citerefentry"><span class="refentrytitle">glFramebufferRenderbuffer</span></span></a>,
            <a class="citerefentry" href="glBindRenderbuffer.xhtml"><span class="citerefentry"><span class="refentrytitle">glBindRenderbuffer</span></span></a>,
            <a class="citerefentry" href="glRenderbufferStorage.xhtml"><span class="citerefentry"><span class="refentrytitle">glRenderbufferStorage</span></span></a>,
            <a class="citerefentry" href="glRenderbufferStorageMultisample.xhtml"><span class="citerefentry"><span class="refentrytitle">glRenderbufferStorageMultisample</span></span></a>
        </p>
      </div>
      <div class="refsect1" id="Copyright">
        <h2>Copyright</h2>
        <p>
            Copyright <span class="trademark"/>© 2010-2014 Khronos Group.
            This material may be distributed subject to the terms and conditions set forth in
            the Open Publication License, v 1.0, 8 June 1999.
            <a class="link" href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
        </p>
      </div>
    </div>
    <footer/>
  </body>
</html>
